home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 11 / CU Amiga Magazine's Super CD-ROM 11 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-06].iso / cucd / sound / soundconvert / docs / ps3mrec.doc < prev    next >
Text File  |  1996-06-22  |  6KB  |  187 lines
  1. ***************************************************************************
  2.                            PS3M recorder v1.9
  3.                     -- FREEWARE --
  4. ***************************************************************************             
  5.  
  6. PS3M recorder is a program that loads several kinds of music module formats
  7. and turns them into IFF, AIFF or RIFF WAVE samples. The usage is very simple:
  8.  
  9. PS3Mrec <module> <dest> <mode> <rate> <boost> <W/S> [pan]
  10.  <module>: module to be recorded (MOD/FT/XM/S3M/MTM)
  11.  <dest>: destination filename
  12.  <mode>: sample type to be created...
  13.     0 = IFF 8-bit stereo
  14.     1 = IFF 8-bit surround
  15.     2 = IFF 8-bit stereo separated
  16.     3 = IFF 8-bit mono
  17.     4 = AIFF 16-bit stereo
  18.     5 = AIFF 16-bit surround
  19.     6 = AIFF 16-bit mono
  20.     7 = RIFF WAVE 16-bit stereo
  21.     8 = RIFF WAVE 16-bit surround
  22.     9 = RIFF WAVE 16-bit mono
  23.  <rate>: sampling rate in Hz (5000-60000)
  24.  <boost>: volume boost (0-999)
  25.  <W/S>: W = write to disk, S = simulate, calculate optimal volume boost
  26.  [pan]: panning value for surround modes (1-99)
  27.  
  28.  
  29. <module>
  30. --------
  31. The module must be unpacked or XPK packed and one of the following formats:
  32. Protracker (MOD), Fasttracker I (FT), Fasttracker II (XM), Screatracker III
  33. (S3M), Multitracker (MTM).
  34.  
  35. ** NOTE:  If you want to load XPK packed modules you must have the
  36. xpkmaster.library and some sublibs installed in Libs:.
  37.  
  38.  
  39. <dest>
  40. ------
  41. Destination filename.
  42.  
  43.  
  44. <rate>
  45. ------
  46. Rate is the sampling rate to be used.  The higher the better sound quality
  47. (and longer rendering time).  
  48.  
  49.  
  50. <boost>
  51. -------
  52. With volume boost you can boost up the volume, obviously.  Too high a value
  53. can cause 'clipping', decreasing the sound quality.  0 means no boost, 100
  54. means double volume, 200 triple etc.
  55.  
  56.  
  57. <W/S>
  58. -----
  59. W = Write the output to disk.
  60. S = Simulate, don't write.  With this switch you can find out the optimal
  61.     volume boost value (max volume without clipping) for each module and mode.
  62.     To get the best sound quality you should first find out the best volume
  63.     boost with simulate and then record using that boost value.
  64.  
  65. ** NOTE:  Every mode (with different panning parameters) can have different
  66.           optimal boost values.
  67.  
  68.  
  69. [pan]
  70. -----
  71. For the surround modes only (1, 5, 8)!
  72. The greater pan value, the louder will the left side be mixed to the right
  73. side and vice versa.  Value 1 is near stereo, and 99 near mono.
  74.  
  75.  
  76.  
  77. Operation
  78. ---------
  79. When recording there will be a progress indicator showing the module time
  80. and how many kilobytes have been recorded.  The process will stop when the
  81. module ends, the user presses CTRL+C (break) or some error occurs.
  82.  
  83. Remember that you will need lot's of hd space.  Example:  A tune lasting
  84. 3:49 with sampling rate 28000 would take (3*60+49)*28000*2=12.2 megabytes
  85. hd space, and twice as much if 16-bit output would have been used.
  86.  
  87.  
  88.  
  89. IFF & AIFF & RIFF WAVE
  90. ----------------------
  91. PS3M recorder offers three different sample formats:
  92.  
  93. IFF 8SVX 8-bit mono/stereo (the Amiga sample format by Electronic Arts),
  94. AIFF 16-bit stereo (used on Apple and SGI),
  95. RIFF WAVE PCM 16-bit stereo (Microsoft Windoze sample format).
  96.  
  97. The stereo modes have the left and right side separated, and surround modes
  98. have the right side mixed to the left and vice versa according to the pan
  99. value.  The mono modes have the both sides mixed together.
  100.  
  101. IFF stereo separated (mode 2) creates two IFF samples, one for the left and
  102. one for the right side.
  103.  
  104. The surroud and mono modes will cause a slight decrease in sound quality
  105. due to additional mixing.
  106.  
  107. 8-bit mixing routines are used for IFF and 16-bit mixing routines for
  108. AIFF/RIFF.
  109.  
  110.  
  111.  
  112.  
  113. Who needs it?
  114. -------------
  115. Those who don't have enough CPU to play all those PC modules with good
  116. quality and at the same time have big hds.  Or, if you want to transfer
  117. modules directly onto audio CDs.  That's the reason for this program to
  118. exist.
  119.  
  120.  
  121.  
  122. Requirements
  123. ------------
  124. Any Amiga, ANY kickstart (even kick1.1 should work :) and some storage
  125. media, preferably a HD.
  126.  
  127. PS3Mrec is quite memory hungry.  You will need about 820kB memory for the
  128. program only, and some more for the module.  But as they say, bigger tables
  129. make faster programs ;-)
  130.  
  131.  
  132.  
  133. Bugs?
  134. -----
  135. Haven't encountered anything serious. Reports appreciated.
  136.  
  137.  
  138.  
  139. Credits
  140. -------
  141. Code by K-P Koljonen / Hippopotamus Design / iNSANE
  142. PS3M 0.960 replayers and mixing system by Jarno Paananen (Guru/Sahara Surfers)
  143. Requested by Hst-Bullah / Hard Disk Cafe
  144.  
  145.  
  146.  
  147. Contact
  148. -------
  149. E-mail: k-p@kalahari.ton.tut.fi   (try this first)
  150.     kp@direktor.voima.jkl.fi  (try this second)
  151.         kpk@pcuf.fi          (try this third)
  152.  
  153. WWW:    http://kalahari.ton.tut.fi/~k-p
  154.  
  155. Snail:    K-P Koljonen
  156.     Torikatu 31
  157.     40900 Säynätsalo
  158.     Finland
  159.  
  160.  
  161.  
  162. History
  163. -------
  164. v1.0            Seems to work.
  165. v1.1 (30.3.1996)    Initial release.
  166. v1.2               A bug fixed, pos/len-counter added,
  167.             AIFF 16-bit support added
  168. v1.3 (2.4.1996)        All in one.
  169. v1.4 (11.4.1996)    Sampling rate used exactly as given.
  170.             Mode 3: separate IFF files for both sides.
  171. v1.5 (20.4.1996)    AIFF stereo mode.
  172.             Real 16-bit mixing for AIFF instead of 8-bit.
  173. v1.6 (24.4.1996)    Added RIFF WAVE (PCM) support.
  174.             Added IFF mono.
  175.             v1.5 mangled the 16-bit data, should work now.
  176.             Different versions for 8-bit and 16-bit mixing.
  177.             Min. sampling rate lowered to 5000.
  178. v1.7 (26.4.1996)    A proper volume boost system for all modes.
  179.             Simulate mode for finding out the optimal boost.
  180.             IFF mode now creates only one file.
  181. v1.8 (12.5.1996)    AIFF MONO and RIFF WAVE MONO added.
  182. v1.9 (22.6.1996)    User-specified destination filename.
  183.             XPK packed files support with xpkmaster.library.
  184.              No need to enter all the zeroes anymore.
  185.             Panning for surround modes.
  186.             000/010 and 020+ optimizations.
  187.